修改及查询商品券信息

修改商品券

品牌方可以通过该接口修改商品券信息。注：修改只会对新发的券生效，历史已经发放给用户的券不会改变。

请求参数	类型	描述
product_coupon_id	string	商品券ID
json	object	声明请求的`JSON`数据结构
brand_id	string	品牌ID
out_request_no	string	修改请求单号
display_info	object	展示信息
name	string	商品券名称
image_url	string	商品券图片
background_url	string	商品券背景图
detail_image_url_list	string[]	商品券详情图列表
original_price	integer	商品原价
combo_package_list	object[]	套餐组合
name	string	套餐名
pick_count	integer	可选单品数量
choice_list	object[]	单品列表
name	string	单品名称
price	integer	单品价格
count	integer	单品数量
image_url	string	单品图片
mini_program_appid	string	单品跳转小程序AppID
mini_program_path	string	单品跳转小程序路径

php

$instance->v3->marketing->partner->productCoupon->productCoupons->_product_coupon_id_->patchAsync([
  'product_coupon_id' => '1000000013',
  'json' => [
    'brand_id'       => '120344',
    'out_request_no' => '34657_20250101_123456',
    'display_info'   => [
      'name'                  => '全场满100立打8折',
      'image_url'             => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
      'background_url'        => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
      'detail_image_url_list' => ['https://wxpaylogo.qpic.cn/wxpayl'],
      'original_price'        => 10000,
      'combo_package_list'    => [[
        'name'        => '咖啡2选1',
        'pick_count'  => 3,
        'choice_list' => [[
          'name'               => '美式',
          'price'              => 10000,
          'count'              => 2,
          'image_url'          => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
          'mini_program_appid' => 'wx4fd12345678',
          'mini_program_path'  => '/pages/index/index',
        ],],
      ],],
    ],
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$instance->chain('v3/marketing/partner/product-coupon/product-coupons/{product_coupon_id}')->patchAsync([
  'product_coupon_id' => '1000000013',
  'json' => [
    'brand_id'       => '120344',
    'out_request_no' => '34657_20250101_123456',
    'display_info'   => [
      'name'                  => '全场满100立打8折',
      'image_url'             => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
      'background_url'        => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
      'detail_image_url_list' => ['https://wxpaylogo.qpic.cn/wxpayl'],
      'original_price'        => 10000,
      'combo_package_list'    => [[
        'name'        => '咖啡2选1',
        'pick_count'  => 3,
        'choice_list' => [[
          'name'               => '美式',
          'price'              => 10000,
          'count'              => 2,
          'image_url'          => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
          'mini_program_appid' => 'wx4fd12345678',
          'mini_program_path'  => '/pages/index/index',
        ],],
      ],],
    ],
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$instance['v3/marketing/partner/product-coupon/product-coupons/{product_coupon_id}']->patchAsync([
  'product_coupon_id' => '1000000013',
  'json' => [
    'brand_id'       => '120344',
    'out_request_no' => '34657_20250101_123456',
    'display_info'   => [
      'name'                  => '全场满100立打8折',
      'image_url'             => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
      'background_url'        => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
      'detail_image_url_list' => ['https://wxpaylogo.qpic.cn/wxpayl'],
      'original_price'        => 10000,
      'combo_package_list'    => [[
        'name'        => '咖啡2选1',
        'pick_count'  => 3,
        'choice_list' => [[
          'name'               => '美式',
          'price'              => 10000,
          'count'              => 2,
          'image_url'          => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
          'mini_program_appid' => 'wx4fd12345678',
          'mini_program_path'  => '/pages/index/index',
        ],],
      ],],
    ],
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$response = $instance->v3->marketing->partner->productCoupon->productCoupons->_product_coupon_id_->patch([
  'product_coupon_id' => '1000000013',
  'json' => [
    'brand_id'       => '120344',
    'out_request_no' => '34657_20250101_123456',
    'display_info'   => [
      'name'                  => '全场满100立打8折',
      'image_url'             => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
      'background_url'        => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
      'detail_image_url_list' => ['https://wxpaylogo.qpic.cn/wxpayl'],
      'original_price'        => 10000,
      'combo_package_list'    => [[
        'name'        => '咖啡2选1',
        'pick_count'  => 3,
        'choice_list' => [[
          'name'               => '美式',
          'price'              => 10000,
          'count'              => 2,
          'image_url'          => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
          'mini_program_appid' => 'wx4fd12345678',
          'mini_program_path'  => '/pages/index/index',
        ],],
      ],],
    ],
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

php

$response = $instance->chain('v3/marketing/partner/product-coupon/product-coupons/{product_coupon_id}')->patch([
  'product_coupon_id' => '1000000013',
  'json' => [
    'brand_id'       => '120344',
    'out_request_no' => '34657_20250101_123456',
    'display_info'   => [
      'name'                  => '全场满100立打8折',
      'image_url'             => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
      'background_url'        => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
      'detail_image_url_list' => ['https://wxpaylogo.qpic.cn/wxpayl'],
      'original_price'        => 10000,
      'combo_package_list'    => [[
        'name'        => '咖啡2选1',
        'pick_count'  => 3,
        'choice_list' => [[
          'name'               => '美式',
          'price'              => 10000,
          'count'              => 2,
          'image_url'          => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
          'mini_program_appid' => 'wx4fd12345678',
          'mini_program_path'  => '/pages/index/index',
        ],],
      ],],
    ],
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

php

$response = $instance['v3/marketing/partner/product-coupon/product-coupons/{product_coupon_id}']->patch([
  'product_coupon_id' => '1000000013',
  'json' => [
    'brand_id'       => '120344',
    'out_request_no' => '34657_20250101_123456',
    'display_info'   => [
      'name'                  => '全场满100立打8折',
      'image_url'             => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
      'background_url'        => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
      'detail_image_url_list' => ['https://wxpaylogo.qpic.cn/wxpayl'],
      'original_price'        => 10000,
      'combo_package_list'    => [[
        'name'        => '咖啡2选1',
        'pick_count'  => 3,
        'choice_list' => [[
          'name'               => '美式',
          'price'              => 10000,
          'count'              => 2,
          'image_url'          => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
          'mini_program_appid' => 'wx4fd12345678',
          'mini_program_path'  => '/pages/index/index',
        ],],
      ],],
    ],
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

返回字典	类型	描述
product_coupon_id	string	商品券ID
state	string	商品券状态 `AUDITING` \| `EFFECTIVE` \| `DEACTIVATED` 枚举值之一
brand_id	string	品牌ID
scope	string	优惠范围 `ALL` \| `SINGLE` 枚举值之一
type	string	商品券类型 `NORMAL` \| `DISCOUNT` \| `EXCHANGE` 枚举值之一
usage_mode	string	使用模式 `SINGLE` \| `SEQUENTIAL` 枚举值之一
single_usage_info	object	单券模式信息
normal_coupon	object	满减券使用规则
threshold	integer	门槛金额
discount_amount	integer	固定减免金额
discount_coupon	object	折扣券使用规则
threshold	integer	门槛金额
percent_off	integer	固定减免百分比
sequential_usage_info	object	多次优惠模式信息
type	string	多次优惠规则类型 `INCREMENTAL` \| `EQUAL` 枚举值之一
count	integer	可使用次数
available_days	integer	多次优惠有效天数
interval_days	integer	多次优惠使用间隔天数
display_info	object	展示信息
name	string	商品券名称
image_url	string	商品券图片
background_url	string	商品券背景图
detail_image_url_list	string[]	商品券详情图列表
original_price	integer	商品原价
combo_package_list	object[]	套餐组合
name	string	套餐名
pick_count	integer	可选单品数量
choice_list	object[]	单品列表
name	string	单品名称
price	integer	单品价格
count	integer	单品数量
image_url	string	单品图片
mini_program_appid	string	单品跳转小程序AppID
mini_program_path	string	单品跳转小程序路径
out_product_no	string	外部商品ID
deactivate_request_no	string	失效请求单号
deactivate_time	string	失效时间
deactivate_reason	string	失效原因

参阅官方文档

查询商品券

品牌方可以通过该接口查询商品券的详细信息，但不包括商品券的批次信息。

请求参数	类型	描述
product_coupon_id	string	商品券ID
query	object	声明请求的查询参数
brand_id	string	品牌ID

php

$instance->v3->marketing->partner->productCoupon->productCoupons->_product_coupon_id_->getAsync([
  'product_coupon_id' => '1000000013',
  'query' => [
    'brand_id' => '120344',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$instance->chain('v3/marketing/partner/product-coupon/product-coupons/{product_coupon_id}')->getAsync([
  'product_coupon_id' => '1000000013',
  'query' => [
    'brand_id' => '120344',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$instance['v3/marketing/partner/product-coupon/product-coupons/{product_coupon_id}']->getAsync([
  'product_coupon_id' => '1000000013',
  'query' => [
    'brand_id' => '120344',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$response = $instance->v3->marketing->partner->productCoupon->productCoupons->_product_coupon_id_->get([
  'product_coupon_id' => '1000000013',
  'query' => [
    'brand_id' => '120344',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

php

$response = $instance->chain('v3/marketing/partner/product-coupon/product-coupons/{product_coupon_id}')->get([
  'product_coupon_id' => '1000000013',
  'query' => [
    'brand_id' => '120344',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

php

$response = $instance['v3/marketing/partner/product-coupon/product-coupons/{product_coupon_id}']->get([
  'product_coupon_id' => '1000000013',
  'query' => [
    'brand_id' => '120344',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

返回字典	类型	描述
product_coupon_id	string	商品券ID
state	string	商品券状态 `AUDITING` \| `EFFECTIVE` \| `DEACTIVATED` 枚举值之一
brand_id	string	品牌ID
scope	string	优惠范围 `ALL` \| `SINGLE` 枚举值之一
type	string	商品券类型 `NORMAL` \| `DISCOUNT` \| `EXCHANGE` 枚举值之一
usage_mode	string	使用模式 `SINGLE` \| `SEQUENTIAL` 枚举值之一
single_usage_info	object	单券模式信息
normal_coupon	object	满减券使用规则
threshold	integer	门槛金额
discount_amount	integer	固定减免金额
discount_coupon	object	折扣券使用规则
threshold	integer	门槛金额
percent_off	integer	固定减免百分比
sequential_usage_info	object	多次优惠模式信息
type	string	多次优惠规则类型 `INCREMENTAL` \| `EQUAL` 枚举值之一
count	integer	可使用次数
available_days	integer	多次优惠有效天数
interval_days	integer	多次优惠使用间隔天数
display_info	object	展示信息
name	string	商品券名称
image_url	string	商品券图片
background_url	string	商品券背景图
detail_image_url_list	string[]	商品券详情图列表
original_price	integer	商品原价
combo_package_list	object[]	套餐组合
name	string	套餐名
pick_count	integer	可选单品数量
choice_list	object[]	单品列表
name	string	单品名称
price	integer	单品价格
count	integer	单品数量
image_url	string	单品图片
mini_program_appid	string	单品跳转小程序AppID
mini_program_path	string	单品跳转小程序路径
out_product_no	string	外部商品ID
deactivate_request_no	string	失效请求单号
deactivate_time	string	失效时间
deactivate_reason	string	失效原因

参阅官方文档

直连商户模式

合作伙伴模式

直连商户模式

合作伙伴模式

直连商户模式

合作伙伴模式

腾讯数电发票模式

区块链电子发票

自建/三方模式

二级商户授权

即时(需用户确认)模式

预约模式

电子回单

免确认

免确认

直连商户模式

合作伙伴模式